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SOFTWARE TECHNICAL DESCRIPTION 

UO INTRODUCTION 

This document describes the ULTRIX-11 software product to 
help prospective customers to make an informed decision con- 
cerning purchasing an ULTRIX-11 system. This software 
description answers the most commonly asked concerns about 
he ULTRIX-11 operating system, such as: 

Number of users 

Licensing 

Hardware configuration requirements 

Disk media requirements 

Product features 

U± WHAT IS ULTRIX -11? 

The ULTRIX-11 system is the 16-bit member of DIGITAL'S 
ULTRIX family of UNIX products. The ULTRIX-11 V2.0 software 
is the second version of Digital's 16-bit UNIX+ product. 
The first version was the V7M-11 V1.0 software. The 
ULTRIX-11 V2.0 software is enhanced in the following areas: 

• New hardware support: J11 micro-processor, disks, 
tapes, and communications devices 

• New software features: the C shell with job control, an 
in-kernel floating point simulator, and the Source Code 
Control System (SCCS) 

• Performance improvements: disk partitioning, overlapped 
seeks, and mapped buffers 

• Improved installation procedures: ease of installation, 
a system acceptance test 

• Improved documentation 

The ULTRIX-11 software product consists of the following: 
the ULTRIX-11 operating system and utility programs, several 
languages, program development tools, and complete documen- 
tation. 

+ UNIX is a trademark of AT&T Bell Laboratories. 
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The ULTRIX-11 operating system is an enhanced version of the 
V7M-11 V1.0 software, which is based on UNIX Time-Sharing 
System, Seventh Edition (V7). In addition, the ULTRIX-11 
system includes numerous enhancements, bug fixes, and addi- 
tional features. 

The following documentation is supplied with the ULTRIX-11 
software: 

ULTRIX -11 Programmer 's Manual , Volumes ±, 2A, and 2B 

An Introduction to Display Editing with vi 

An Introduction to the Source Code Control System 

An Introduction to the C Shell 

Screen Updating" and Cursor Movement Optimization 

ULTRIX - 1 1 Programmer 's Guide 

ULTRIX - 11 Software Technical Description 

ULTRIX -11 Installation Guide 

ULTRIX - 1 1 System Management Guide 

The ULTRIX-11 system runs on memory-managed PDP11 proces- 
sors, supports a wide range of peripheral devices, and is 
fully supported by DIGITAL. This support includes the fol- 
lowing: hardware maintenance by Digital Field Service, war- 
ranty, telephone support, product updates, a software 
dispatch, and software consultation for application develop- 
ment. You can install the ULTRIX-11 software yourself or 
you can purchase installation from Digital Software Ser- 
vices. 

I'l 525? 1§ ™5 ULTRIX -11 SOFTWARE DISTRIBUTED ? 

The ULTRIX-11 software is distributed on four types of 
media: magnetic tape, RL02 disk packs, RC25 disk cartridge, 
or RX50 5-inch floppy diskettes. Each distribution kit 
includes the set of manuals described in section 1.1. Each 
distribution kit supports a subset of the possible system 
disks. Use table 1.1 to match the type of load media with 
your system disk and select the appropriate distribution kit 
for your system. 
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TABLE 1.1 
Load Media System Disks 



RX50 RD51/RD52 

RL02 RL02 

RC25 RC25 

MAGNETIC TAPE RL01/2 

RC25 (fixed disk) 

RK06/7 

RP02/3 

RP04/5/6 

RM02/3/5 

RA60/RA80/RA81 

^.2.2 Magnetic Tape Distribution 

The magnetic tape distribution is available at 800 BPI for 
use with the TM11 and TM02/3 magnetic tape controllers, or 
at 1600 BPI for use with the TS11, TU80, TSV05, and TM03 
controllers. The 1600 BPI distribution tape cannot be used 
with the TM02 tape controller due to the lack of the auto 
density select feature. 

The distribution magnetic tape contains a boot program and 
other standalone programs, a dump/restore image of the 
ULTRIX-11 root file system and of the /usr file system, and 
the ULTRIX-11 OPTIONAL FILES in tape archive (tar) format. 

The standalone programs load the ULTRIX-11 file systems onto 
the system disk for you. You use the tar command to load 
the OPTIONAL FILES as required. The root file system con- 
tains the ULTRIX-11 binaries. The /usr file system holds 
the following: user libraries, user binaries, UUCP, various 
administrative files, SCCS, Fortran 77, and software 
development tools. The OPTIONAL FILES include: the games 
programs (/usr/games) , the on-line manuals (/usr/man) from 
the ULTRIX -11 Programmer 's Manual , Volume 1, and the UNIX 
documents (Tusr/doc) from the ULTRIX - 1 1 Programmer 's Manual , 
Volumes 2A and 2B. 

1.2.2 RL02 Distribution 

The RL02 distribution consists of a root and /usr disk pack, 
and an OPTIONAL FILES disk pack. The root and /usr disk 
contains the ULTRIX-11 root and /usr file systems and the 
standalone programs. The contents of these file systems are 
the same as the magnetic tape distribution. The OPTIONAL 
FILES disk contains: the games (/usr/games), on-line manual 
pages (/usr/man), and the UNIX documents (/usr/doc). To 
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facilitate loading, the OPTIONAL PILES are provided in both 
tar format and an ULTRIX-11 file system containing the 

files. 

1.2.3 RC25 Distribution 

The RC25 distribution consists of a single RC25 disk car- 
tridge containing: the boot and standalone programs, the 
root and /usr file systems, and the optional files. The 
root and /usr file systems are the same as the magnetic tape 
distribution. The optional files are the same as the RL02 
distribution, but are supplied in tar format only. You use 
the standalone programs to copy the RC25 distribution onto 
the RC25 fixed disk, which then becomes the system disk. 

1.2.4 Micro / PDP -1 1 Distribution 

To allow convenient loading on the Micro/PDP-11, the 
ULTRIX-11 distribution has been repackaged. The Micro/PDP- 
11 distribution consists of 30 RX50 5-inch floppy diskettes. 

TABLE 1 . 2 

Number of Diskettes Contents 



1 BOOT and standalone programs 

6 ROOT file system 

3 /USR file system 

3 SYSGEN files 

I USEP 

II OPTIONAL SOFTWARE 
1 GAMES 

4 ON-LINE MANUALS 

The standalone programs load the root and /usr file systems 
and the system generation files onto the RD51 or RD52 Win- 
chester disk for you. These file systems contain only the 
basic ULTRIX-11 software, those files required to operate 
the system. You use the Optional Software Load command 
(OSLOAD) to load the items of optional software needed for 
your installation. This scheme allows you to optimize file 
storage on the Winchester disk. 

The UNIX documents files (/usr/doc) are not supplied with 
the RX50 distribution. These documents are supplied in 
hardcopy. The documents files are available on RX50 
diskettes by contacting the Digital Telephone Support 
Center. 

U3 HOW IS THE ULTRIX -11 SOFTWARE LICENSED ? 

The ULTRIX-11 software is licensed for use on a single CPU 
according to the number of users. You obtain this single 
use binary license directly from DIGITAL. No other licenses 
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are required. There are two classes of licenses: for 1-16 
users and for 1-32 users. The 16-user license is available 
on magnetic tape, RL02, RC25, and RX50 media. The 32-user 
license is available on magnetic tape only. The 16-user 
license cannot be upgraded to 32 users. Refer to the 
ULTRIX-11 Software Product Description for ordering and 
licensing information. 

For licensing purposes, a user is defined as any terminal 
that is available for user logins, that is, has a login pro- 
cess running. This lets you connect as many communications 
ports to the system as the hardware can support, with the 
restriction that only 16 (or 32) of those ports may be 
available for users to log in. Printer ports and dialout 
lines do not count as users. This is an important differ- 
ence between the ULTRIX-11 software and V7M-11, which con- 
trolled the number of users by limiting the number of com- 
munications ports. 
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2.0 HARDWARE REQUIREMENTS 

The ULTRIX-11 software supports a wide range of PDP-11 pro- 
cessors and peripherals. The information in this section 
should be used to verify that the customer's existing or 
proposed hardware configuration is supported by the ULTRIX- 
11 software. 

2. J[ ULTRIX -11 SUPPORTED HARDWARE 

The following tables list the processors, peripherals, and 
the degree of ULTRIX-11 support. The processors are 
separated into two groups: processors with separate Instruc- 
tion and Data space and processors without separate Instruc- 
tion and Data space. This division is done mostly for con- 
venience, although it reflects the two versions of the 
ULTRIX-11 kernel. 

The separate I and D space kernel for the larger processors 
is listed in Table 2.1, and the overlay kernel used with the 
smaller processors is listed in Table 2.2. 

Use this key to read the tables: 
Key: 

F Fully supported device. When pertaining to disks, this 
indicates the disk can be the system disk. Regarding 
magnetic tapes, it can be the distribution load device. 

S Supported as a user device only. When pertaining to 
disks, this indicates the disk cannot be the system 
disk, but can be used for user file storage. Regarding 
magnetic tapes, it cannot be the distribution load dev- 
ice, because this device cannot handle full size reels. 

Obsolete device. A driver is provided, but the device 
is not supported. Digital does not recommend use of 
this device. Digital provides no warranty, and does 
not accept SPRs for this device. 

N Not supported. 
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Table 2.1 
ULTRIX-11 Hardware Support on Separate I & D Processors 



Processor 



11/44 11/45 11/55 11/70 11/73 *11 



Memory 

Clocks: 
KW11-L 
KW11-P 



*1 
*2 



Floating Point *15 



Console Terminal 

Disk Drives: 
RK05 

RL01/2 *13 
RX50 

RD51/RD52 
RC25 
RK06/7 
RM02 
RM03/5 
RP02/3 
RP04/5/6 
RA60 

RA80/RA81 
RX02 *12 
ML11 
RS03/4 

Tape Drives: 
TM11-TS03 
TM11-TU10/TE10 
TS11 *5 

TU80 *5 
TSV05 *5 
TK25 *5 
TM02/3-TU77 
TM02/3-TU16/TE16 
TC11-TU56 



256KB 256KB 256KB 256KB 256KB 



F 


F 


F 


F 




F *10 


F 


F 


F 


F 




N 


FP11F 


FP11B 


FP11B 


FP11C 


*16 




FP11C 


FP11C 


FP11B 




*3 


*3 


*3 


*3 


i 


*3 


S 


S 


S 


S 




N 


F 


F 


F 


F 




F 


S 


S 


S 


S 




S 


N 


N 


N 


N 




F 


F 


F 


F 


F 




F 


F 


F 


F 


F 




N 


F 


F 


F 


F 


*4 


N 


N 


N 


N 


F 




N 


F 


F 


F 


F 


*4 


N 


F 


F 


F 


F 




N 


F 


F 


F 


F 




N 


F 


F 


F 


F 




N 


S 


S 


S 


S 




S 


S 


S 


S 


S 




N 
















N 


S 


s 


S 


S 


*4 


N 


F 


F 


F 


F 


*4 


N 


F 


F 


F 


F 




N 


F 


F 


F 


F 




N 


N 


N 


N 


N 




F 


N 


N 


N 


N 




S 


F 


F 


F 


F 




N 


F 


F 


F 


F 




N 


N 


N 


N 


N 




N 
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Table 2.1 
ULTRIX-11 Hardware Support on Separate I & D Processors 

(Continued) 



Line Printers: 



LP11 *14 


F 


F 


F 


F 


N 


Printer port *17 


F 


F 


F 


F 


F 


Communication Devices: 












DL11 *6 


F 


F 


F 


F 


F 


DZ11 


F 


F 


F 


F 


N 


DZV11/DZQ11 


N 


N 


N 


N 


F 


DH11 


F 


F 


F 


F 


N 


DM-11BB *7 


F 


F 


F 


F 


N 


DHV11 


N 


N 


N 


N 


F 


DHU11 


F 


F 


F 


F 


N 


DN11 














N 


DU1 1 














N 
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Table 2.2 
ULTRIX-11 Hardware Support on Non-Separate I & D Processors 



Processor 



M11 
*8 



11/23+ 
*9 



11/24 11/34 11/40 11/60 



Memory 

Clocks: 
KW11-L 
KW11-P 



*1 



*2 



256KB 256KB 



256KB 256KB 256KB 



256KB 



Floating Point *15 
Console Terminal 
Disk Drives: 



RK05 




RL01/2 


*i: 


RX50 




RD51/RD52 




RC25 




RK06/7 




RM02 




RM03/5 




RP02/3 




RP04/5/6 




RA60 




RA80/81 




RX02 


*i: 


ML11 




RS03/4 




Tape Drives: 




TM11-TS03 




TM11-TU10/TE10 




TS11 


*5 


TU80 


*5 


TSV05 


*5 


TK25 


*5 


TM02/3-TU77 




TM02/3-TU16/TE16 


TC11-TU56 





*10 


*10 


F 


F 


F 


F 


N 


N 


F 


F 


F 


F 


KEF 11 


KEF 11 


KEF 11 


FP11A 


None 


FP11E 


FPF11 


FPF11 


FPF11 








*3 


*3 


*3 


*3 


*3 


*3 


N 


N 


S 


S 


S 


S 


F 


F 


F 


F 


F 


F 


S 


S 


S 


S 


S 


S 


F 


F 


N 


N 


N 


N 


F 


F 


F 


F 


F 


F 


N 


N 


F 


F 


F 


F 


N 


N 


F 


F 


F 


F 


N 


N 


N 


N 


N 


N 


N 


N 


F 


F 


F 


F 


N 


N 


F 


F 


F 


F 


N 


N 


F 


F 


F 


F 


N 


N 


F 


F 


F 


F 


S 


S 


S 


S 


S 


S 


N 


N 


S 


S 


S 


S 


N 


N 














N 


N 


S 


S 


s 


S 


N 


N 


F 


F 


F 


F 


N 


N 


F 


F 


F 


F 


N 


N 


F 


F 


F 


F 


F 


F 


N 


N 


N 


N 


S 


S 


N 


N 


N 


N 


N 


N 


F 


F 


F 


F 


N 


N 


F 


F 


F 


F 


N 


N 


N 


N 


N 


N 
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Table 2.2 
ULTRIX-11 Hardware Support on Non-Separate I & D Processors 

(Continued) 



Line Printers: 
















LP11 


*14 


N 


N 


F 


F 


F 


F 


Printer Port 


*17 


F 


F 


F 


F 


F 


F 


Communications 


Devices 


• 
■ 












DL11 


*6 


F 


F 


F 


F 


F 


F 


DZ11 




N 


N 


F 


F 


F 


F 


D7V11/DZQ11 




F 


F 


N 


N 


N 


N 


DH11 




N 


N 


F 


F 


F 


F 


DM11-BB 


*7 


N 


N 


F 


F 


F 


F 


DHV11 




F 


F 


N 


N 


N 


N 


DHU11 




N 


N 


F 


F 


F 


F 


DN11 




N 


N 














DU11 




N 


N 
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Notes: 

*1 The ULTRIX-11 operating system will operate with a 
minimum of 192KB of memory. However, 256KB is the 
practical minimum memory size. Some large programs, 
such as vi and f77, may not run on 192KB systems. The 
ULTRIX-11 operating system supports up to 3.75MB (4MB - 
I/O page) of main memory. A minimum of 512 KB of 
memory is required to take full advantage of the mapped 
buffer feature (average 15% system performance improve- 
ment ) . 

*2 The DL11-W includes a KW11-L clock. 

*3 You can use most terminals as the system console, but a 
terminal that can produce hard copy output is recom- 
mended. You cannot use upper case only terminals as 
the console terminal. If you use LA120 as the system 
console, you should disable the auto disconnect 
feature. 

*4 These devices are not normally configured on the 
PDP11/70. 



* 



5 Only a single TS1 1/TU80/TSV05/TK25 tape drive is sup- 
ported. 



*6 DL11 includes all versions of the DL11 used as single 
line units. It also includes the DLV1 1 on Q bus pro- 
cessors, and the second single line unit supplied with 
the Micro/PDP-11, PDP11-23, PDP11/23 PLUS, PDP11/24 and 
PDP11/44. 

*7 Modem control option for the DH11. 

*8 M11 is short for the KDF11-B version of the Micro/PDP- 
11. This is a PDP11/23 PLUS processor. 

*9 This column applies to the PDP11/23 as well as the 
PDP 11/23 PLUS. 

*10 The system must have a 60 HZ clock that can be 
enabled/disabled via bit six of the CLOCK CSR at 
address 777546. The Micro/PDP-11 and PDP11/73 proces- 
sors include the 60 HZ clock. 

*11 PDP11/73 refers to the KDJ11-A micro-processor module 
and Micro PDP11/73 system (KDJ11-B), used in Q bus sys- 
tems. If the KDJ11-A is used to replace a PDP11/23 
PLUS, such as the Micro/PDP-11, a multifunction module 
containing a bootstrap must also be provided. The sin- 
gle line unit for the system console must also be pro- 
vided. The MXV11-BF multifunction module may be used, 
but it is not recommended because its on-board memory 
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is non-parity memory. 

*12 One dual RX02 drive is supported, 18 bit addressing 
only. On Q22 bus processors, the RX02 can only be 
accessed via the ULTRIX-11 buffered I/O mechanism. The 
physical (RAW) I/O system cannot be used to access the 
RX02. 

*13 For the RL01, two drives are required. For the RL02, 
two drives are recommended. 

*14 The LP11 line printer driver supports only a single 
unit. 

*15 The ULTRIX-11 operating system kernel floating point 
simulator allows programs that execute floating point 
instructions to run on processors without floating 
point hardware. However, floating point hardware is 
highly recommended for intensive floating point appli- 
cations and/or where performance is a factor. 

*16 The PDP11/73 (KDJ11-A) includes the floating point 
instruction set in the micro-code. Do not use the KEF11 
or FPF1 1 . 

*17 Printer port refers to a printer, such as the LA120, 
LA100, or LA50 connected to a port on one of the sup- 
ported communications devices. 
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2.2 



ULTRIX-11 NON-SUPPORTED HARDWARE 



UNIX Seventh Edition (V7) contains full or partial support 
for several hardware devices that the ULTRIX-11 software 
does not support. The ULTRIX-11 software does not support 
these devices because there is no device driver, the device 
is obsolete, or device support cannot be verified. 

The ULTRIX-11 software does not support the following dev- 
ices: 

CR11 , DJ11 , PC 11 , DC 11 , RF11 , TC11 

• No ULTRIX-11 device drivers are available for these 
devices. 

DN11 , DU11 , RS03 /4 

• The V7 drivers for these devices have been updated to 
function with the ULTRIX-11 operating system kernel. 
However, these devices are not supported by DIGITAL and 
their use is not recommended. 

C/A/T Phototypesetter Interface ( DR1 1 -C driver ) 

• This device operates on non-DIGITAL supplied hardware 
and is not supported. The V7 C/A/T driver has been 
updated to function with the ULTRIX-11 operating system 
kernel. The ULTRIX-11 kernel supports the C/A/T 
(DR11-C) driver only to the extent that it delivers 
characters written to the file /dev/cat to the output 
cable of the DR11-C. Actual connection and operation 
of the phototypesetter is the customer's responsibil- 
ity. 



2.3 



MINIMUM HARDWARE CONFIGURATION 



The ULTRIX-11 software requires a minimum hardware confi- 
guration consisting of a processor, clock, memory, disk, and 
in some configurations, a magnetic tape. Use the following 
guidelines to ensure that ULTRIX-11 software supports your 
proposed or existing hardware configuration. 

• Processor 

Refer to Table 2.1 and Table 2.2 to verify if the 
ULTRIX-11 software supports the processor, the proces- 
sor has sufficient memory, and has a clock. The pro- 
cessor must have memory management. 

• Disk 

The configuration must include at least one of the 
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fully supported disks from Table 1 . 1 or Table 1.2. The 
ULTRIX-11 software requires two drives if the system 
disk is an RL01. When the entire ULTRIX-11 distribu- 
tion is loaded, it nearly fills two RL01 disk packs, 
one RL02 disk pack, or one RK06 disk pack. Although 
you can salvage some disk space by not loading unneces- 
sary files (such as the documents and games programs), 
the amount of user file space is severly limited. For 
the RL01 disk, DIGITAL recommends three drives. For the 
RL02 and RK06 disks, DIGITAL recommends two drives. 

• Magnetic tape 

The configuration should include one of the fully sup- 
ported magnetic tapes from Table 1 . 1 or Table 1.2. The 
type of magnetic tape controller dictates the density 
of the ULTRIX-11 distribution tape: 800 BPI for the 
TM11 and TM02/3, or 1600 BPI for the TS11, TSV05, TU80, 
and TM03 (not TM02) . 

• Communications 

The configuration should include a communications 
interface with enough lines to support the maximum 
number of simultaneous users on the system. 

2.4 OPTIONAL EQUIPMENT 

The following guidelines can be useful in selecting optional 
equipment. 

• Cache Memory 

Cache memory is desirable to improve processor perfor- 
mance. The PDP11/44, PDP11/60, PDP11/70, and PDP11/73 
processors are equipped with cache memories; the 
remaining processors are not. The PDP11/34 has an 
optional KK11-A cache. 

• Floating Point Processor 

The ULTRIX-11 kernel does not require or use floating 
point. However, some system commands, such as iostat, 
accounting, and the debugger, do use floating point. 
The floating point hardware requirement depends on the 
amount of floating point operations the user's programs 
execute, and the performance requirements of those pro- 
grams. 

An optional floating point simulator can be configured 
into the ULTRIX-11 kernel. This simulator allows pro- 
grams that require floating point support to run on a 
processor without floating point hardware. The perfor- 
mance of the simulator should be sufficient for the 
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ULTRIX-11 utility programs. The simulator performance 
for user programs is application dependent. For float- 
ing point intensive applications DIGITAL recommends the 
floating point hardware. 

The Micro/PDP-11, PDP11/23, and PDP11/24 processors 
have two floating point options: The KEF11-AA (a float- 
ing point chip installed to the processor module), and 
the FPF11 (a floating point processor on a separate 
module). The FPF11 is the faster option. 

Disks 

There are several factors you should consider when 
determining how many disk drives your system requires. 
These include the number of users, the number and size 
of their files, and any data base requirements (the 
amount of required disk capacity). Multiple disk 
drives are convenient for copying disks, and are manda- 
tory for file system backups when the configuration 
does not include a magnetic tape. If you require very 
high availability, multiple disk drives should be con- 
sidered, because disks are the most likely system com- 
ponent to fail. Multiple drive systems usually continue 
to operate when one disk fails. 

Magnetic tape 

DIGITAL recommends your hardware configuration include 
a magnetic tape for file system backup and restore 
operations, receiving ULTRIX-11 software updates, and 
information interchange with the UNIX software user 
community. Multiple tape drives are generally not 
necessary, unless you need to copy magnetic tapes 
directly. 

Line Printer 

The need for a line printer depends on the type of work 
to be done on the system, and is an optional feature. 

Communications Devices 

You can include additional communications interfaces in 
the hardware configuration. However, you must consider 
the following limiting factor: the number of terminals 
available for logins is limited to the 16 or 32 users 
specified in the ULTRIX-11 software license. For exam- 
ple, if you purchase a 16-user ULTRIX-11 sublicense, up 
to 16 communications ports can have a login process 
running. The ULTRIX-11 operating system enforces this 
restriction. Communications ports used to drive 
printers and UUCP/TIP dialout lines do not count as 
users. 
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2.5 CONFIGURING FOR THE NUMBER OF USERS TO BE SUPPORTED 

The 16 or 32 user limit in the ULTRIX-11 license agreements 
is for licensing purposes only. The actual number of users 
depends on the hardware configuration and other factors. 
The following descriptions define the number of simultaneous 
interactive users a ULTRIX-11 system can support on various 
hardware configurations. 

For this discussion, a user is an ULTRIX-11 program develop- 
ment job mix, such as edits, compiles, debugging, and nroff 
text processing. The number of users ULTRIX-11 supports 
depends on the hardware configuration and the type of work 
the users are performing. If every user is editing, the 
number increases; if the users are all running nroff, the 
number decreases. Response time requirements also affect 
the number of users. 

• Micro/PDP-11 (11/23+ processor) 

The Micro/PDP-11 with the 11/23+ processor and 256KB of 
memory supports two users; with 512KB of memory, it 
supports four users. Increasing the Micro/PDP-11 
memory size beyond 512KB is beneficial when users are 
running either a large number of subprocesses or very 
large subprocesses. 

User file storage space on the RD51 (10 megabyte) disk 
is limited. For two or more users, DIGITAL recommends 
the RD52 (30 megabyte) disk or a second RD51 disk. 

• Micro/PDP-11 (11/73 processor) 

The Micro/PDP-11 with the 11/73 processor and 256KB of 
memory supports three users; with 512KB of memory it 
supports six users. With an RD52 disk and 512KB of 
memory, the Micro/PDP-1 1/73 supports up to eight users. 
Increasing the memory size improves the system's per- 
formance. The Micro/PDP-1 1/73 with an RC25 as the sys- 
tem disk and one megabyte of memory supports up to 16 
users. 

User file storage space on the RD51 (10 megabyte) disk 
is limited. For two or more users, DIGITAL recommends 
the RD52 (30 megabyte) disk or a second RD51 disk. For 
eight or more users, DIGITAL recommends the RC25 (dual 
26 megabyte) disk. 

• PDP11/23, PDP11/23+, andPDP11/24 

Any of these processors configured with dual RL02 disks 
and 256KB of memory can support two users. With 512KB 
of memory, these processors support up to four users. 
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• PDP 11/34 and PDP 11/40 

The PDP11/40 with 256KB of memory supports from four to 
six users, depending on the type of disks used. The 
PDP11/34 with 256KB of memory supports four users with 
dual RL02 disks, six users with dual RK07 disks, or 
eight users with an RM02 or RP04/5/6 disk. Adding the 
KK11-A cache memory to the PDP11/34 improves system 
performance and increases the number of users. 

• PDP 11/60 

The PDP11/60 with 256KB of memory supports six users 
with dual RL02 disks, eight users with dual RK07 disks, 
and ten users with an RM02 or RP04/5/6 disk. 

• PDP 11/44 

The PDP11/44 with 256KB of memory and dual RL02 disks 
supports five users, and with 512KB of memory it sup- 
ports seven users. The PDP11/44 with 512KB of memory 
and dual RK07 disks supports up to 10 users. The 
PDP11/44 with 768KB of memory and an RM02 or RP04/5/6 
disk supports 14 users. 

• PDP11/45 and PDP11/55 

Either processor with 256KB of memory can support 10 
users with dual RK07 disks, or 16 users with RM02 or 
RP04/5/6 disk. 

• PDP11/70 

The PDP11/70 with 512KB of memory and a single RM03/5 
or RP04/5/6 supports 20 users. A fully configured 
PDP11/70 with additional memory and disk drives sup- 
ports 30 users. 

Performance Improvements 

Performance deteriorates as the amount of swapping 
increases. You can increase system performance by adding 
more memory to reduce swapping. Using a fast disk such as 
the ML11 for the swap device also increases performance. 
Locating the root, swap, and /tmp file systems on separate 
disk controllers improves system I/O throughput. Placing 
the /tmp file system on a fast disk improves the performance 
of the C compiler and nroff. 

2.6 DEVICE ADDRESS / VECTOR ASSIGNMENTS 

The system clock, disk, magnetic tape, and console terminal 
must be configured for the standard address and vector 
assignments. Since DIGITAL ships all systems with these 
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devices at the standard address and vector, this should not 
concern the customer. You can configure other devices, such 
as communications interfaces and secondary disks, to any 
desired address and vector. You can change the device 
address and vector assignments at system generation time. 
However, for communications interfaces, you must sequen- 
tially address and vector multiple units of the same type. 
Table 2.3 shows the addressing of three DH11 units, each 
with modem control: 

TABLE 2.3 

Device Unit Address Vector 



DM11-BB 





770500 


300 




1 


770510 


304 




2 


770520 


310 


DH11 





760020 


320 




1 


760040 


330 




2 


760060 


340 



These devices normally follow DIGITAL'S floating address and 
vector rules, which are fully supported by the ULTRIX-11 
software. If you configure multiple DH11 interfaces and not 
every DH11 unit has modem control, you should address the 
units with modem control first, followed by the units 
without modem control. This lets the DH11 device driver 
correctly associate each DH11 unit with its modem control 
unit. 

If the system has multiple MSCP disk controllers (UDA50, 
KLESI, RQDX1, RUX1), only one of them will be at the stan- 
dard address of 172150. You can use the ULTRIX-11 boot 
program's CSR command to enter the CSR address if the system 
disk controller is not at the standard address. This lets 
you install the ULTRIX-11 software on an MSCP disk that is 
not at the standard address. DIGITAL recommends that the 
system disk controller be at the standard address for more 
convenient bootstrap operation. 



2-13 



3.0 DISK MEDIA REQUIREMENTS 

Traditionally, UNIX operating systems require all disk media 
to be completely free of hard errors. Soft errors were 
tolerated in most cases. The ULTRIX-11 software supports 
the DIGITAL standard bad block replacement strategy for most 
of the larger disks. In most cases, this eliminates the 
requirement for error free media. The following paragraphs 
define the ULTRIX-11 disk media requirements: 

• RK05, RL01, RL02, RX02, and RX50 

The ULTRIX-11 software does not support bad block 
replacement for these disks, so the media must be free 
of bad blocks. The RK05, RX02, and RX50 disks are small 
enough to usually be free of bad blocks. DIGITAL 
recommends using the RL01-EF and RL02-EF (hard error 
free disk packs) for the RL01/2 disk drives. 

• RD51 and RD52 

The controller for these disks implements controller 
initiated bad block replacement. The controller 
automatically detects bad blocks and revectors each bad 
block to a replacement block. This makes the disk 
media appear to be error free to the operating system. 

• RP02 and RP03 

The ULTRIX-11 software does not support bad block 
replacement for these disks. The media must be hard 
error free. The RP03-PX disk pack meets this require- 
ment. 

• RK06/7, RM02/3/5, and RP04/5/6 

The ULTRIX-11 software fully supports bad block 
replacement for these disks, so the media need not be 
hard error free. However, the number and location of 
bad blocks can adversely affect system performance. The 
ULTRIX-11 software includes standalone programs which 
format and surface verify these disk packs. These 
standalone programs aid in determining the affect of 
any bad blocks on system performance. Refer to section 
4.8, Disk Bad Block Replacement, for more information. 

• RC25, RA60, RA80, and RA81 

These disks contain a factory initialized bad block 
replacement file to make the media appear error free to 
the operating system. These disks also use an error 
correction mechanism to enable the operating system to 
warn the system manager a disk block is going bad 
before it becomes unreadable. 
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The controllers for these disks implement cooperative 
bad block replacement. The software and the hardware 
cooperate to replace bad blocks. The ULTRIX-11 system 
includes programs that initialize the disk during 
installation to ensure that all bad blocks have been 
replaced and lets the system manager replace any bad 
blocks that occur during normal system operation. 
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4.0 ULTRIX -11 SOFTWARE FUNCTIONAL DESCRIPTION 

The ULTRIX-11 software is the second release of V7M-11, 
which is based on the UNIX Time-Sharing System, Seventh Edi- 
tion (V7) and includes most features of that software. 
Refer to the attached Summary for a description of those V7 
features. The following functional description covers only 
the enhancements that distinguish the ULTRIX-11 software 
from V7, and the V7M-11 V1.0 software. 

4.2 THE ULTRIX -1 1 SOFTWARE IS CUSTOMER INSTALLABLE 

ULTRIX-11 design, packaging, and documentation allow it to 
be installed by any customer with a basic knowledge of com- 
puter systems. The ULTRIX-11 software is designed to be 
completely field reconf igurable from binaries. It requires 
no source code files to regenerate the operating system. 
The ULTRIX-11 documentation describes the procedures to con- 
figure a system to run the software, install the software in 
the system, and manage the system after the ULTRIX-11 
software becomes operational. 

One of the major improvements in the ULTRIX-11 software com- 
pared to V7M-11 is the automated system installation and 
initial setup. The ULTRIX-11 software installation is 
automated by two interactive programs: system disk load 
(SDLOAD) and initial setup (SETUP). The SDLOAD program is 
used only with the magnetic tape and RX50 distributions. 
The RL02 and RC25 distributions come with the software 
already loaded. 

To install the software, you boot the distribution media, 
answer questions about the system configuration, then the 
autoinstall programs take over and install the ULTRIX-11 
software. After the autoinstall completes, you generate a 
new ULTRIX-11 kernel to match your hardware configuration 
and setup user accounts. 

You use the ULTRIX-11 System Acceptance Test (USAT) and the 
User-mode System Exerciser Package (USEP) to verify whether 
the system hardware and the ULTRIX-11 software are function- 
ing properly. 

4.2 ULTRIX -11 SYSTEM ACCEPTANCE TEST ( USAT ) 

The ULTRIX-11 System Acceptance Test verifies that the 
operating system and its major subsystems are functioning 
properly. USAT performs the following tests: 

• "AWK TEST" The awk test is a short script which gen- 
erates a table of temperature conversions. Tempera- 
tures for Celsius, Fahrenheit, and Kelvin are computed 
for the Kelvin temperature range to 500 degrees, in 
5-degree Kelvin increments. The resulting table, 100 
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lines long by 3 columns wide, is compared with a file 
containing a known, correct temperature table. The 
test fails if the temperature tables do not match. 

"BC TEST" The be test calculates the value of e, the 
base of natural logarithms, to 50 decimal places. The 
resulting output is compared with the known, correct 
value of e. The test fails if the two values do not 
match. 

"DC TEST" The dc test generates a list of temperatures. 
Celsius, Fahrenheit, and Kelvin temperatures are 
printed for temperatures ranging from 5 to 400 degrees 
Kelvin, in 5-degree Kelvin increments. This file of 
temperatures is 240 lines long, one temperature per 
line. The test output is compared with a file contain- 
ing a known, correct version of the temperature list. 
The test fails if the temperature lists do not match. 

"C COMPILER TEST" The C compiler test compiles a C pro- 
gram using the cc flags -s -0, which generates a table 
of temperature conversions. Temperatures for Celsius, 
Fahrenheit, and Kelvin are computed for the Kelvin tem- 
perature range to 500 degrees, in 5 degree Kelvin 
increments. The resulting table, 100 lines long by 3 
columns wide, is compared with a file containing a 
known, correct temperature table. The test fails if 
the temperature tables do not match. 

"DOC PREP TEST" The document preparation test runs a 
variety of editing commands. The test procedure uses 
copy, ed, diff, spell, nroff, grep and ex on various 
files. 

Initially, a 300-line file containing 5541 bytes of 
text is copied using cp. The text editor ed then is 
invoked, and the word 'newproc' is substituted for the 
word 'proc' throughout the file (20 substitutions). A 
comparison is made between this file and the original 
version using the diff command. The output is compared 
with a file containing the known, correct differences 
between the two files. 

Spell is run on the file, and the output is compared 
with a file containing the known, correct spell list. 
The file is sent through nroff, and the output is com- 
pared with a file containing a known, correct nroff 
output. Grep -v is used to redirect all lines not con- 
taining the word "Printed" in them. Finally, the edi- 
tor ex is invoked, and 'newproc' is substituted for 
'proc' throughout the file (20 substitutions). The 
document preparation test fails if any of the test com- 
mands fail. 
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"F77 COMPILER TEST" The Fortran test compiles a Fortran 
program using the F77 compiler, which generates a table 
of temperatures. Celsius, Fahrenheit and Kelvin tem- 
peratures are printed for the Kelvin temperature range 
to 500 degrees, in 5-degree Kelvin increments. The 
resulting 100-line table of temperatures is compared 
with a file containing a known, correct version of the 
output. The test fails if the temperature tables do 
not match. 

"LEARN TEST" The learn test simulates a learn session 
in order to verify that learn is functional. Learn is 
run starting with lesson 5.1a (the section on files) 
and continues for six lessons (up to lesson 6.2a). The 
output from a prearranged list of responses is compared 
with a file containing the known, correct responses 
given by learn. The test fails if the output files do 
not match. 

"LEX TEST" The lex test is a short test to insure that 
lex is functioning. A lex script compresses multiple 
blanks and converts uppercase input to lowercase. The 
input file is the output generated by a ps -alx com- 
mand. The lex-generated C program is compiled and exe- 
cuted using the prearranged input file. Output is com- 
pared with a file containing the known, correct output. 
The test fails if the output files do not match. 

"LINT TEST" Lint is run on a file containing known lint 
errors, and the output is compared with a known, 
correct lint-generated error list. If the two error 
lists do not match, the test fails and an error message 
is printed. 

"PCC TEST" The pec test is a test of the Portable C 
compiler. A program, which generates a table of tem- 
peratures, is compiled using pec and then executed. 
Celsius, Fahrenheit, and Kelvin temperatures are 
printed for the Kelvin temperature range to 500 
degrees, in 5-degree Kelvin increments. The resulting 
100 line table of temperatures is compared with a file 
containing a known, correct version of the output. The 
test fails if the temperature tables do not match. 

"SED TEST" The sed test runs sed (stream editor) on a 
short file. The input file is a listing generated by a 
ps -alx command. Blanks, as well as the digits and 
1, are replaced with <null> characters throughout the 
file (814 substitutions). The output file then is com- 
pared with a file containing the known, correct output. 
The sed test fails if the two output files do not 
match. 

"YACC TEST" The yacc test generates a table of 
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temperature conversions. Celsius, Fahrenheit, and Kel- 
vin temperatures are printed for the Kelvin temperature 
range to 500 degrees, in 5-degree Kelvin increments. 
The resulting 100-line table of temperatures is com- 
pared with a file containing a known, correct version 
of the output. The test fails if the temperature 
tables do not match. 

"SYSTEM STATS" This test checks such things as memory 
usage, process status, and free disk space. The com- 
mands included are: who, ps, pstat, memstat, bufstat, 
iostat, and df. The output is sent to a logfile which 
is printed following the completion of the entire usat 
test script. 



4.3 AUTOMATED SYSTEM GENERATION 

ULTRIX-11 system generation is accomplished with an interac- 
ive program called SYSGEN. The SYSGEN program automates 
system generation by: 

Prompting for information about the configuration 

Creating a file describing the configuration 

Making the ULTRIX-11 kernel based on that file 

Guiding the customer through the installation of the 
new ULTRIX-11 kernel. 

The SYSGEN program can also list, print, and remove confi- 
guration files and can print a list of the devices supported 
by ULTRIX-11, along with their ULTRIX-11 device mnemonics. 
The SYSGEN program includes extensive on-line help messages 
to guide the customer through the system generation process. 

4.4 SYSTEM TUNING 

The ULTRIX-11 software uses a set of parameters to define 
the size of the disk I/O buffer cache and other kernel 
internal data structures, such as the process and inode 
tables. You can change the values of these parameters at 
system generation time without recompiling any source code 
modules. The SYSGEN program contains default values for 
these parameters, or you can specify a value for any or all 
of the parameters at system generation time. The parameter 
values become part of the system configuration file. 

4.5 PROCESSOR AND PERIPHERAL DEVICE SUPPORT 

Because the ULTRIX-11 software supports a very wide range of 
processors and peripheral devices, you can tailor the system 
hardware configuration to match an application closely. See 
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Table 2.1 and Table 2.2 for a detailed listing of all sup- 
portable hardware. The ULTRIX-11 software also supports the 
DIGITAL Storage Architecture (DSA) disks which use the Mass 
Storage Control Protocol (MSCP) . This architecture allows 
new DSA disks to be supported with only minimal changes to 
the software device driver. 

4.6 Vi Editor 

The ULTRIX-11 system includes version 3.7 of the vi screen 
editor from the University of California at Berkeley, 4.1 
Berkeley Software Distribution. Under the ULTRIX-11 
software, the vi editor runs on any supported processor. 
The LISP code has been removed from the vi editor and is not 
supported. The ULTRIX-11 version of vi supports the TAGS 
feature, which was not supported by vi under V7M-11. 

4.7 TERMINAL ENABLING EDITOR ( TED ) 

The TED command lets you enable terminals and set terminal 
characteristics without knowing how to use a text editor. 
Previously, enabling terminals required editing files and 
possibly sending a signal to the init process. The TED com- 
mand has safeguards against such errors as disabling the 
user's current login terminal and creating multiple entries 
for the same terminal. 

4.8 OVERLAID TEXT KERNELS 

Due to the size of the kernel, V7 only su^pjrts processors 
with separate Instruction and Data space. The kernel con- 
sists of two major segments, the text segment and the data 
segment. The text segment contains the PDP-11 instructions 
executed when the kernel is running. The data segment con- 
sists of the data structures the PDP-11 instructions refer- 
ence. 

If the processor has the separate I and D space feature, the 
memory management hardware maps the text and data segments 
separately. A processor without separate I and D space maps 
the text and data as a single segment, thus limiting the 
size of the kernel. For processors with separate I and D 
space, the kernel can be as large as 64KB of text and 48KB 
of data. For processors without separate I and D space, the 
size of the kernel is limited to a total of 48KB. 

The V7 kernel can be forced to fit into the 48KB of address 
space available on processors without separate I and D 
space. However, this leaves no space available to support 
any users. To resolve this, the ULTRIX-11 system uses the 
text overlay kernel with mapped buffers. The overlay kernel 
is implemented with memory resident overlays which use 
dynamic remapping of the kernel text space. The overlay 
kernel also maps the disk I/O buffer cache outside kernel 
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address space. 

The text overlay and mapped buffer schemes lets the ULTRIX- 
11 software support any reasonable hardware configuration on 
processors without separate I and D space. V7M-11 used a 
separate I and D space version of the kernel for processors 
with this feature. The ULTRIX-11 software also uses a 
separate I and D space kernel, but with text overlays and 
mapped buffers. This allows for even larger kernels on 
separate I and D processors. 

4.9 OVERLAID TEXT USER PROCESSES 

The lack of separate Instruction and Data space imposes a 
64KB size limit on user processes. This size limitation 
would prevent several of the larger user programs such as 
vi, f77, awk, lex, and others, from executing on processors 
without separate I and D space. The ULTRIX-11 software has 
a user overlay mechanism to allow these programs to run 
without separate I and D space. For extremely large pro- 
grams like the vi editor, the ULTRIX-11 software employs 
user overlays on processors with separated I and D space. 

You can apply this overlay scheme to customer generated 
applications. The generation of overlaid user processes is 
fully documented. The ULTRIX-11 V2.0 software makes the 
user program overlay mechanism easier to use, and this is 
further enhanced by improved documentation. 

4.JH3 SYSTEM PERFORMANCE IMPROVEMENTS 

The ULTRIX-11 software includes performance improvements 
over V7M-11. The RL02 and RD51/RD52 disk drivers have been 
partitioned to reduce seek time to the swap area. Queue 
sorting and overlapped seeks have been added to the RL02 
driver. On systems with a memory size of 512Kb or larger, 
an average 15% increase in overall system performance is 
achieved by the use of an improved disk I/O buffer caching 
scheme and mapped buffers. These features are based on the 
University of California at Berkeley 2.9 BSD software. 

4.JM GENERAL DISK DRIVERS 

The V7M-11 software required a separate copy of the disk 
driver for each disk controller. The ULTRIX-11 software has 
two general disk drivers. The HP driver supports up to 
three MASSBUS disk controllers. The RA driver supports up 
to three Mass Storage Control Protocol (MSCP) disk controll- 
ers. The general disk drivers allow support of multiple disk 
controllers without the overhead of multiple copies of the 
disk driver. 
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The MASSBUS controllers are: 

RH11 - up to eight drives (RM02, RP04, RP05, RP06, ML11). 
RH70 - up to eight drives (RM02, RM03, RM05, RP04, RP05, 
RP06, ML11). 

The MSCP controllers are: 

UDA50 - up to four drives (RA60, RA80, RA81). 

KLESI - up to two RC25 units (2 drives per RC25 unit). 

RQDX1 - up to four drives (RX50, RD51, RD52). 

RUX1 - up to four drives (RX50). 

The general MSCP disk driver supports three controllers, but 
only one of each type; that is, only one UDA50, KLESI, 
RQDX1 , or RUX1 . 
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DISK BAD BLOCK REPLACEMENT 



The ULTRIX-11 system uses a bad 
for the larger disks. Refer 
Requirements, for a description 
by bad block replacement. The 
ment software includes three st 
bad block scan program (bads), 
program (rabads), and the (dski 
non-MSCP disks supported by 
software. 



block replacement strategy 
to section 3.0, Disk Media 

of the disk types supported 

ULTRIX-11 bad block replace- 
andalone programs: the quick 

the MSCP disk initialization 
nit) program for initializing 

the bad block replacement 



You use the bads program to scan the disk media quickly and 
identify any existing bad blocks, or to print the contents 
of the factory recorded bad block file. 

You use the dskinit program to format the disk media and 
perform a complete surface verification with multiple test 
data patterns. The dskinit program also adds any bad blocks 
to the factory-recorded bad block file, or creates the bad 
block file if it does not already exist. 

You use the rabads program to initialize the MSCP disks to 
insure that all bad blocks have been replaced before the 
software is installed. You also use rabads to replace 
dynamic bad blocks, blocks that go bad during normal system 
operations. 

The ULTRIX-11 disk drivers are modified to read the bad 
block file and automatically replace any bad block. This 
bad block replacement is transparent to the operating system 
and the users. For the MSCP disks, the hardware does the 
bad block revectoring instead of the software driver. 



Bad blocks in frequently-accessed areas of the 
file system (such as the I-list and swap area), 
negative impact on system performance. That is, 



ULTRIX-11 

can have a 

each bad 
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block replacement operation involves a seek to the end of 
the disk to access the replacement block. ULTRIX-11 bad 
blocking includes a bad block status command (badstat) to 
monitor and display the number of replacements performed on 
each bad block. This command also lets the system manager 
assess the effect of bad block replacements on system per- 
formance. 

4.13 UN I BUS MAP ALLOCATION 

The V7 kernel allocates the entire UNIBUS map for each I/O 
transfer. This allows only a single device to use the map at 
any one time. The ULTRIX-11 system uses a more efficient 
UNIBUS map allocation algorithm, allowing several devices to 
use the map concurrently. This increases the amount of 
UNIBUS device I/O overlap and, therefore, system I/O 
throughput. This change is required when using fully buf- 
fered disk controllers such as the UDA50. 

4.J_4 ASSIGNABLE TTY STRUCTURES 

V7M-11 used assignable TTY structures to limit the number of 
active users to the number specified in the binary subli- 
cense agreement. The ULTRIX-11 software employs a less res- 
trictive method of enforcing the number of users limit. The 
ULTRIX-11 software assigns TTY structures automatically. 
The user no longer needs to be concerned about TTY structure 
assignments. 

4.J5 TTY CONTROL CHARACTERS AND TERMINAL DRIVER 

DIGITAL has modified the ULTRIX-11 TTY driver to allow set- 
ting the terminal control characters with the stty command. 
This can improve erase and kill processing for video termi- 
nals. If desired, you use the stty command to set the stan- 
dard control characters. The default control characters are 
now <CTRL/C> for interrupt, <DELETE> for erase, and <CTRL/U> 
for kill. 

The ULTRIX-11 system lets you select either the standard V7 
terminal driver or the new terminal driver, on a per user 
basis. The new terminal driver is the University of Cali- 
fornia at Berkeley 2.9 BSD terminal driver, used with the C 
shell and job control software. 

The ULTRIX-11 software includes the getty table 
(/etc/gettytab) and terminal capabilities data base 
(/etc/termcap) from the University of California at Berkeley 
2.9 software. These features allow the system to accommo- 
date the characteristics of a wide variety of different ter- 
minal types. 
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4.^6 LPR - LINE PRINTER SPOOLER 

The ULTRIX-11 software includes an improved line printer 
spooler. The spooler includes the printer capabilities file 
(/etc/printcap) from the University of California at Berke- 
ley 2.9 BSD software. The /etc/printcap file lets you 
specify the characteristics of multiple printers from a sin- 
gle control file. The spooler supports one printer on an 
LP11 parallel interface and additional printers on communi- 
cations ports (DH11, DZ11, etc.). The spooler includes com- 
mands to show the line printer queue and delete jobs from 
the line printer queue. 

4. V7 C SHELL WITH JOB CONTROL 

The ULTRIX-11 software includes the C shell with job control 
from the University of California at Berkeley 2.9 BSD 
software. The C shell is a command language interpreter 
with C-like syntax and a command history mechanism. The C 
shell also supports Bourne shell commands and syntax. The 
job control facility allows users to suspend processes, 
place them in the background or foreground, and monitor 
their status. 

4 . J_8 SPECIAL FILES 

The operating system requires some special files in order to 
access devices. For V7, you must create these file indivi- 
dually using the mknod command. The RP06 disk requires 16 of 
these special files for each drive. The msf (Make Special 
Files) command has been added to the ULTRIX-11 software to 
allow creation of all the special files for a device with a 
single command. 

4. V9 FILE SYSTEM TABLE 

The ULTRIX-11 software includes a file system table 
(/etc/fstab) containing the names of the system and user 
file systems and the directory names where the system and 
user file systems are mounted. All system commands requir- 
ing file system names as input have been modified to use the 
names in fstab as the default file system names. These com- 
mands include fsck, df, quot, mount, and umount. Also, the 
-a option is added to the mount and umount commands to allow 
mounting and dismounting all file systems with a single com- 
mand. 

4.20 USER - MODE SYSTEM EXERCISER PACKAGE ( USEP ) 

The User-mode System Exerciser Package (USEP) consists of a 
collection of user-mode exerciser modules to exercise the 
hardware using the ULTRIX-11 operating system. There are 
USEP modules for the processor, memory, floating point, 
disks, magnetic tapes, communications interfaces, and the 
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line printer. USEP runs under the control of the System 
Exerciser Control Program (sysx). The system manager uses 
sysx to create an exerciser script file, start and stop the 
exercisers, and monitor USEP while it is running. 

The DIGITAL Field Service engineer can load ULTRIX-11 and 
USEP from a magnetic tape onto a scratch disk and analyze 
hardware failures using an operating system identical to the 
one normally used by the customer on that hardware. 

The ULTRIX-11 software includes an enhanced USEP that exer- 
cises the new hardware supported by the ULTRIX-11 operating 
system. The sysx program has been enhanced to provide 
better control of the exerciser programs and improved help 
messages. 

4.2^ ERROR LOGGING 

The ULTRIX-11 error logger collects information about system 
and device errors when they occur and saves the information 
in the error log file for later analysis. The ULTRIX-11 
error logging system consists of four major components: 

• The error log initialization program (eli) performs 
such house-keeping functions as saving the error log 
file, zeroing the error log file, enabling and disa- 
bling error logging, and printing the size of the error 
log file. 

• The ULTRIX-11 kernel and device drivers gather error 
information and save it in the kernel error log buffer. 

• The error log copy process (elc), a background process, 
copies error log records from the kernel buffer into 
the error log file. 

• The error log print program (elp) formats the error log 
data and generates error reports. 

The error logging system has been updated to include support 
for new devices supported by the ULTRIX-11 operating system. 

4.22 CRASH DUMP ANALYZER 

The ULTRIX-11 software takes a crash dump by writing an 
image of all the processor's memory to the crash dump dev- 
ice. The crash dump device can be magnetic tape, RX50 
diskettes, or the swap area on the system disk. 

The crash dump analysis program (cda) extracts all available 
information concerning the crash from this memory image and 
formats it into a crash dump analysis report. The cda 
report provides information about unlogged errors, hardware 
traps (panic traps), the memory usage map, I/O buffer cache 
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usage, and active processes. The program also dumps many of 
the operating system's internal data structures. 

4.23 MAINTAINABILITY IMPROVEMENTS 

The ULTRIX-11 kernel is more fault tolerant and provides 
improved error information when a fault occurs. The 
ULTRIX-11 kernel contains a large number of bug fixes and 
the documentation explains system and device error messages. 

4.24 SOURCE CODE CONTROL SYSTEM 

The SYSTEM III Source Code Control System (SCCS) and the 
SCCS interface program from the University of California at 
Berkeley 4.2 BSD software are included in the ULTRIX-11 sys- 
tem. The ULTRIX-11 source code is developed under SCCS con- 
trol. 

4.25 SYSTEM V COMMANDS 

The following commands have been ported from the AT&T UNIX 
SYSTEM V release to the ULTRIX-11 software: 

cpio - Copy file archives 

cut - Cut selected fields from a file 

dcopy - Copy file system for optimum access 

ed - Text editor 

paste, - Merge same lines of several files 

label it - Label file system volumes 

volcopy - Copy file systems with label checking 

4.26 OPERATOR SERVICES PROGRAM 

The operator services program provides an interface between 
he operating system and the system operator. Operator ser- 
ices enables the operator to perform the following func- 
ions: 

Obtain on-line help 

Shutdown the system to single-user mode 

Restart multiuser mode operation 

Halt the processor 

Run file system consistency checks 

Perform file system backups 

Escape to a shell and execute ULTRIX-11 commands 
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4.27 SYSTEM MANAGEMENT COMMANDS 

ULTRIX-11 includes several commands designed to aid the sys- 
tem manager with monitoring the system and maintaining the 
file system. You use the file system debugger (fsdb) to 
more safely modify or repair the ULTRIX-11 file system. You 
use the ipatch command to dump and/or modify an inode. The 
iostat disk and CPU usage commands have been vastly 
improved. The bufstat command displays the status of the 
I/O buffer cache. The memstat command prints a map of the 
usage of all memory on the system. 

4.28 PLOT LIBRARY 

The UNIX V7 plot library has been updated to support the VT 
240 and VT241 terminals in Tektronix 4014 emulation mode. 

4.29 TAPE ARCHIVER COMMAND 

The ULTRIX-11 software includes an improved version of the 
tar command. The tar command now saves or restores empty 
directories and special files. The meaning of the p flag 
has changed: it now specifies that files will be extracted 
with the mode as written on the tape instead of the mode 
indicated by the current user's umask. The new tar command 
is compatible with tapes written by previous versions of tar 
and vice versa. 

4.30 MAIL SYSTEM 

The ULTRIX-11 software improves the mail system by imple- 
menting the mail front end (mail command) from the Univer- 
sity of California at Berkeley 2.9 BSD software. 

4.3_2 TIP - REPLACES CALL UNIX COMMAND (cu) 

The tip command enables an ULTRIX-11 system to connect to 
another computer system. The tip command provides a virtual 
terminal facility from the ULTRIX-11 system to a remote sys- 
tem. It also allows for the transfer of ASCII text files 
between the ULTRIX-11 system and a remote UNIX system. It 
connects to the remote system with a hardwired direct con- 
nection, a direct connect with dedicated modems, or over a, 
telephone line using a DIGITAL DF02-AC or DF03-AC auto call 
modem. The DF02-AC operates at 300 bits per second; the 
DF03-AC bit rate is switch selectable to 300 or 1200 BPS. 
The tip virtual terminal facility supports bit rates of 110, 
150, 300, 1200, 2400, 4800, and 9600 bits per second. The 
tip command reliably transfers text files at speeds up to 
and including 2400 bits per second on all processors. 
Speeds up to 9600 bits per second can be used on faster pro- 
cessors, such as the 11/73 (J11). 

The original cu command from V7 is included in the ULTRIX-11 
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system as cu_v7. This command is obsolete and is not sup- 
ported. The version of cu from V7M-11 is also retained in 
the ULTRIX-11 system as cu v7m. This command is supported 
but its use is not recommended". The tip command supports 
the cu user interface, so the user can enter cu commands and 
tip emulates cu. 

The tip command was ported to ULTRIX-11 from the University 
of California at Berkeley 2.9 BSD software. 

4.3_2 ADDITION OF USER WRITTEN DEVICE DRIVERS 

The ULTRIX-11 system provides for adding up to four user- 
written device drivers. This is accomplished with four pro- 
totype device drivers containing all of the functions and 
definitions required to interface with the operating system. 
The user edits the code for the new device driver into one 
of the prototype files and uses the sysgen program to con- 
figure the new device into the ULTRIX-11 kernel. 

The ULTRIX-11 user driver interface has been greatly 
improved to provide a more complete interface to the kernel. 
The user driver interface now includes a much more detailed 
description of how to write a driver and interface it to the 
kernel. 

4.3_3 IMPROVED UUCP 

The ULTRIX-11 system includes a vastly improved version of 
UUCP, which contains all currently known bug fixes. 
ULTRIX-11 also includes the UUCP Administrator's Guide, 
which simplifies the installation and administration of the 
UUCP software. The ULTRIX-11 software now uses sethostname 
and gethostname calls to implement the system's UUCP name. 

4.34 FLOATING POINT SIMULATOR IN THE KERNEL 

The V7M-11 software implemented floating point simulation by 
linking a floating point simulator library to each program 
that needed to execute floating point instructions. This 
method was slow and increased the size of the programs. 

On the ULTRIX-11 system, you configure the floating point 
simulation code into the kernel if the processor does not 
have floating point hardware. This simulator provides a 50% 
speed increase in floating point instruction execution, com- 
pared to the user level floating point simulator library. 
The in-kernel floating point simulator allows all system and 
user programs that require floating point support to run on 
processors without the floating point hardware. 

For applications involving intensive floating point calcula- 
tions or requiring high floating point performance, the 
floating point hardware is recommended. 
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4.35 ULTRIX -11 NON - SUPPORTED SOFTWARE 

The following features/programs from UNIX V7 are not 
included in the ULTRIX-11 software: 

CRYPT Command 
Packet Driver 
Multiplexed Files 
DC11 Device Driver 
TC11 Device Driver 
RF11 Device Driver 

All forms of encryption and decryption have been removed 
from the ULTRIX-11 software, with the exception of the one 
way password encryption algorithm. This allows the ULTRIX-11 
software to be shipped outside the United States of America 
without the special export license required if the encryp- 
tion software were included. Customers located in the 
United States can obtain a kit for the reinstallation of the 
encryption software by contacting the DIGITAL Telephone Sup- 
port Center. 

ULTRIX-11 contains the following V7 software, but this 
software is not supported: 

bas - BASIC interpreter 

C/A/T - Phototypesetter interface 

cu - Call UNIX command (original version) 

factor - Factor a number 

m4 - Macro processor 

primes - Generate large primes 

ratfor - Rational Fortran interpreter 

pkopen(3) - Packet Driver Simulator 

DN11 driver 

DU11 driver 

RS03/4 driver 

Multi-volume file systems 

Versatec printer-plotter software 

All games 

On-line manuals (/usr/man) 

UNIX documents (/usr/doc) 

troff and associated macro packages 

These software features are included in the ULTRIX-11 
software and should function as in V7. The ULTRIX-11 system 
does not support these features. Software performance 
reports will be accepted but are handled on a best effort 
basis. That is, there is no guaranteed response. 

The on-line manuals (/usr/man) are updated with each new 
ULTRIX-11 release. Software performance reports are handled 
on a best effort basis. The UNIX documents (/usr/doc) are 
not updated with new releases. These are the UNIX documents 
from V7 . Software performance reports are not accepted for 
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The troff phototypesetter text processing software is 
included and functions as in V7. It is currently not sup- 
ported, but this could change in a future release. Software 
performance reports are handled on a best effort basis. 



The ULTRIX-11 distribution includes 
ported software: 



the following nonsup- 



m11 - MACRO- 11 Assembler 

111 - Linker 

macxrf - Cross reference 



Software performance reports are handled on a 
basis. 



best effort 
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7th Edition UNIX — Summary 

September 6, IV7R 

Bell Laboratories 
Murray Hill. New Jersey 07974 



A. What's new: highlights of the 7th edition UNIXt System 

Aimed at larger systems. Devices are addressable to 2 bytes, files to 2 bytes. 128K 
memory (separate instruction and data space) is needed for some utilities. 

Portability. Code of the operating system and most utilities has been extensively revised to 
minimize its dependence on particular hardware. 

Fortran 77. F77 compiler for the new standard language is compatible with C at the object 
level. A Fortran structurer. STRUCT, converts old, ugly Fortran into RATFOR, a structured 
dialect usable with F77. 

Shell. Completely new SH program supports string variables, trap handling, structured pro- 
gramming, user profiles, settable search path, multilevel file name generation, etc. 

Document preparation. TROFF phototypesetter utility is standard. NROFF (for terminals) is 
now highly compatible with TROFF. MS macro package provides canned commands for many 
common formatting and layout situations. TBL provides an easy to learn language for prepar- 
ing complicated tabular material. REFER fills in bibliographic citations from a data base. 

UNIX-to-UNIX file copy. UUCP performs spooled file transfers between any two machines. 

Data processing. SED stream editor does multiple editing functions in parallel on a data 
stream of indefinite length. AWK report generator does free-field pattern selection and arith- 
metic operations. 

Program development. MAKE controls re-creation of complicated software, arranging for 
minimal recompilation. 

Debugging. ADB does postmortem and breakpoint debugging, handles separate instruction and 
data spaces, floating point, etc. 

C language. The language now supports definable data types, generalized initialization, block 
structure, long integers, unions, explicit type conversions. The LINT verifier does strong type 
checking and detection of probable errors and portability problems even across separately com- 
piled functions. 

Lexical analyzer generator. LEX converts specification of regular expressions and semantic 
actions into a recognizing subroutine. Analogous to YACC. 

Graphics. Simple graph-drawing utility, graphic subroutines, and generalized plotting filters 
adapted to various devices are now standard. 

Standard input-output package. Highly efficient buffered stream I/O is integrated with format- 
ted input and output. 

Other. The operating system and utilities have been enhanced and freed of restrictions in 
many other ways too numerous to relate. 
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B. Hardware 

The 7th edition UNIX operating system runs on a DEC PDP-1 1/45 or 1 1/70* with at least 
the following equipment: 

I28K to 2M words of managed memory; parity not used. 

disk: RP03, RP04, RP06. RK05 (more than 1 RK05) or equivalent. 

console typewriter. 

clock: KWl'.-L or KW11-P. 

The following equipment is strongly recommended: 

communications controller such as DL1 1 or DH1 1. 

full duplex 96-character ASCII terminals. 

9-track tape or extra disk for system backup. 

The system is normally distributed on 9-track tape. The minimum memory and disk space 
specified is enough to run and maintain UNIX. More will be needed to keep all source on line, 
or to handle a large number of users, big data bases, diversified complements of devices, or 
large programs. The resident code occupies 12-20K words depending on configuration; system 
data occupies 10-28K words. 

There is no commitment to provide 7th edition UNIX on PDP- 11/34, 11/40 and 11/60 
hardware. 

C. Software 

Most of the programs available as UNIX commands are listed. Source code and printed 
manuals are distributed for all of the listed software except games. Almost all of the code is 
written in C. Commands are self-contained and do not require extra setup information, unless 
specifically noted as "interactive." Interactive programs can be made to run from a prepared 
script simply by redirecting input. Most programs intended for interactive use (e.g., the editor) 
allow for an escape to command level (the Shell). Most file processing commands can also go 
from standard input to standard output ("filters"). The piping facility of the Shell may be used 
to connect such filters directly to the input or output of other programs. 

1. Basic Software 

This includes the time-sharing operating system with utilities, a machine language assem- 
bler and a compiler for the programming language C— enough software to write and run new 
applications and to maintain or modify UNIX itself. 

1.1. Operating System 

Q UNIX The basic resident code on which everything else depends. Supports the system 

calls, and maintains the file system. A general description of UNIX design phi- 
losophy and system facilities appeared in the Communications of the ACM, 
July, 1974. A more extensive survey is in the Bell System Technical Journal 
for July-August 1978. Capabilities include: 
O Reentrant code for user processes. 
O Separate instruction and data spaces. 
O "Group" access permissions for cooperative projects, with overlapping 

memberships. 
C Alarm-clock timeouts. 
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D DEVICES 



D BOOT 
□ MKCONF 



O Timer-interrupt sampling and interprocess monitoring for debugging and 

measurement. 
O Multiplexed I/O for machine-to-machine communication. 

All I/O is logically synchronous. I/O devices are simply files in the file system. 
Normally, invisible buffering makes all physical record structure and device 
characteristics transparent and exploits the hardware's ability to do overlapped 
I/O. Unbuffered physical record I/O is available for unusual applications. 
Drivers for these devices are available; others can be easily written: 
O Asynchronous interfaces: DH11, DL11. Support for most common ASCII 

terminals. 
O Synchronous interface: DP11. 
O Automatic calling unit interface: DN11. 
OLine printer: LPll. 
O Magnetic tape: TU 1 and TU 1 6. 
ODECtape: TCI I. 

O Fixed head disk: RSI 1, RS03 and RS04. 

OPack type disk: RP03, RP04, RP06; minimum-latency seek scheduling. 
O Cartridge-type disk: RK05, one or more physical devices per logical device. 
ONull device. 

O Physical memory of PDP-1 1, or mapped memory in resident system. 
O Phototypesetter: Graphic Systems System/1 through DR11C. 

Procedures to get UNIX started. 

Tailor device-dependent system code to hardware configuration. As distributed, 
UNIX can be brought up directly on any acceptable CPU with any acceptable 
disk, any sufficient amount of core, and either clock. Other changes, such as 
optimal assignment of directories to devices, inclusion of floating point simula- 
tor, or installation of device names in file system, can then be made at leisure. 



1.2. User Access Control 

□ LOGIN Sign on as a new user. 

O Verify password and establish user's individual and group (project) identity. 

O Adapt to characteristics of terminal. 

O Establish working directory. 

O Announce presence of mail (from MAIL). 

O Publish message of the day. 

O Execute user-specified profile. 

O Start command interpreter or other initial program. 

D PASSWD Change a password. 

O User can change his own password. 

O Passwords are kept encrypted for security. 

Q NEWGRP Change working group (project). Protects against unauthorized changes to pro- 
jects. 

1.3. Terminal Handling 



O TABS Set tab stops appropriately for specified terminal type. 

□ STTY Set up options for optimal control of a terminal. In so far as they are deducible 

from the input, these options are set automatically by LOGIN. 
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O Half vs. full duplex. 

O Carriage return + line feed vs. newline. 

O Interpretation of tabs. 

O Parity. 

O Mapping of upper case to lower. 

O Raw vs. edited input. 

O Delays for tabs, newlines and carriage returns. 



1.4. File Manipulation 



D CAT 



Concatenate one or more files onto standard output. Particularly used for una- 
dorned printing, for inserting data into a pipeline, and for buffering output that 
comes in dribs and drabs. Works on any file regardless of contents. 

Copy one file to another, or a set of files to a directory. Works on any file 
regardless of contents. 

Print files with title, date, and page number on every page. 

OMulticolumn output. 

O Parallel column merge of several files. 

Off-line print. Spools arbitrary files to the line printer. 

Compare two files and report if different. 

Print last // lines of input 

O May print last //characters, or from /; lines or characters to end. 

Split a large file into more manageable pieces. Occasionally necessary for edit- 
ing (ED). 

Physical file format translator, for exchanging data with foreign systems, espe- 
cially IBM 370*s. 

Sum the words of a file. 



1.5. Manipulation of Directories and File Names 

□ RM Remove a file. Only the name goes away if any other names are linked to the 

file. 

OStep through a directory deleting files interactively. 

O Delete entire directory hierarchies. 

G LN "Link" another name (alias) to an existing file. 

G MV Move a file or files. Used for renaming files. 

a CHMOD Change permissions on one or more files. Executable by files" owner. 

D CHOWN Change owner of one or more files. 

□ CHGRP Change group (project) to which a file belongs. 
D MKDIR Make a new directory. 

D RMDIR Remove a directory. 

D CD Change working directory. 

G FIND Prowl the directory hierarchy finding every file that meets specified criteria. 



D CP 


a PR 


a LPR 


a CMP 


a TAIL 


a SPLIT 


a DD 


G SUM 
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O Criteria include: 

name matches a given pattern, 

creation dale in given range, 

date of last use in given range, 

given permissions, 

given owner, 

given special file characteristics, 

boolean combinations of above. 
O Any directory may be considered to be the root. 
O Perform specified command on each file found. 



1.6. Running of Programs 



□ SH 



a TEST 

D EXPR 

D WAIT 
D READ 
D ECHO 

D SLEEP 
D NOHUP 
D NICE 



The Shell, or command language interpreter. 

O Supply arguments to and run any executable program. 

O Redirect standard input, standard output, and standard error files. 

O Pipes: simultaneous execution with output of one process connected to the 

input of another. 
O Compose compound commands using: 

if ... then ... else, 

case switches, 

while loops, 

for loops over lists, 

break, continue and exit, 

parentheses for grouping. 
O Initiate background processes. 

O Perform Shell programs, i.e., command scripts with substitutable arguments. 
O Construct argument lists from all file names satisfying specified patterns. 
OTake special action on traps and interrupts. 
OUser-settable search path for finding commands. 
O Executes user-settable profile upon login. 
O Optionally announces presence of mail as it arrives. 
O Provides variables and parameters with default setting. 

Tests for use in Shell conditionals. 

O String comparison. 

O File nature and accessibility. 

O Boolean combinations of the above. 

String compulations for calculating command arguments. 
O Integer arithmetic 
O Pattern matching 

Wait for termination of asynchronously running processes. 

Read a line from terminal, for interactive Shell procedure. 

Print remainder of command line. Useful for diagnostics or prompts in Shell 
programs, or for inserting data into a pipeline. 

Suspend execution for a specified time. 

Run a command immune to hanging up the terminal. 

Run a command in low (or high) priority. 



□ KILL Terminate named processes. 

D CRON Schedule regular actions at specified times. 

O Actions are arbitrary programs. 

O Times are conjunctions of month, day of month, day of week, hour and 
minute. Ranges are specifiable for each. 

□ AT Schedule a one-shot action for an arbitrary time. 

O TEE Pass data between processes and divert a copy into one or more files. 

1.7. Status Inquiries 



a ls 



a FILE 


D DATE 


G DF 


D DU 


C QUOT 


D WHO 



a ps 



a IOSTAT 
QTTY 

a pwd 



List the names of one, several, or all files in one or more directories. 
O Alphabetic or temporal sorting, up or down. 

O Optional information: size, owner, group, date last modified, date last 
accessed, permissions, i-node number. 

Try to determine what kind of information is in a file by consulting the file sys- 
tem index and by reading the file itself. 

Print today's date and time. Has considerable knowledge of calendric and horo- 

logical peculiarities. 

O May set UNIX's idea of date and time. 

Report amount of free space on file system devices. 

Print a summary of total space occupied by all files in a hierarchy. 

Print summary of file space usage by user id. 

Tell who's on the system. 

O List of presently logged in users, ports and times on. 

O Optional history of all logins and logouts. 

Report on active processes. 
OList your own or everybody's processes. 
OTell what commands are being executed. 

O Optional status information: state and scheduling info, priority, attached ter- 
minal, what it's waiting for, size. 

Print statistics about system I/O activity. 

Print name of your terminal. 

Print name of your working directory. 



1.8. Backup and Maintenance 



D MOUNT Attach a device containing a file system to the tree of directories. Protects 
against nonsense arrangements. 

D UMOUNT Remove the file system contained on a device from the tree of directories. 
Protects against removing a busy device. 

D MKFS Make a new file system on a device. 

D MKNOD Make an i-node (file system entry) for a special file. Special files are physical 
devices, virtual devices, physical memory, etc. 



DTP 
Q TAR 



D DUMP 

□ RESTOR 

D SU 

D DCHECK 

□ ICHECK 
a NCHECK 



a CLRI 
a SYNC 



Manage lile archives on magnetic tape or DECtapc. TAR is newer. 

OCollect files into an archive. 

O Update DECtape archive by date. 

O Replace or delete DECtape files. 

O Print table of contents. 

O Retrieve from archive. 

Dump the file system stored on a specified device, selectively by date, or 
indiscriminately. 

Restore a dumped file system, or selectively retrieve parts thereof. 

Temporarily become the super user with all the rights and privileges thereof. 
Requires a password. 



Check consistency of file system. 

O Print gross statistics: number of files, number of directories, number of spe- 
cial files, space used, space free. 
O Report duplicate use of space. 
O Retrieve lost space. 
O Report inaccessible files. 
O Check consistency of directories. 
O List names of all files. 

Peremptorily expunge a file and its space from a file system. Used to repair 
damaged file systems. 

Force all outstanding I/O on the system to completion. Used to shut down 
gracefully. 



1.9. Accounting 

The liming information on which the reports are based can be manually cleared or shut off 
completely. 



D AC 



D SA 



Publish cumulative connect time report. 
O Connect time by user or by day. 
O For all users or for selected users. 

Publish Shell accounting report. Gives usage information on each command 

executed. 

O Number of times used. 

O Total system time, user time and elapsed time. 

O Optional averages and percentages. 

O Sorting on various fields. 



1.10. Communication 



n MAIL Mail a message to one or more users. Also used to read and dispose of incom- 

ing mail. The presence of mail is announced by LOGIN and optionally by SH. 
O Each message can be disposed of individually. 
O Messages can be saved in files or forwarded. 
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Q CALENDAR Automatic reminder service for events of today and tomorrow. 

D WRITE Establish direct terminal communication with another user. 

D WALL Write to all users. 

D MESG Inhibit receipt of messages from WRITE and WALL. 

D CU Call up another time-sharing system. 

O Transparent interface to remote machine. 

O File transmission. 

OTake remote input from local file or put remote output into local file. 

O Remote system need not be UNIX. 

D UUCP UNIX to UNIX copy. 

O Automatic queuing until line becomes available and remote machine is up. 

OCopy between two remote machines. 

O Differences, mail, etc., between two machines. 

1.11. Basic Program Development Tools 

Some of these utilities are used as integral parts of the higher level languages described in sec- 
tion 2. 

O AR Maintain archives and libraries. Combines several files into one for housekeep- 

ing efficiency. 
O Create new archive. 
O Update archive by date. 
O Replace or delete files. 
O Print table of contents. 
O Retrieve from archive. 

O AS Assembler. Similar to PAL-11, but different in detail. 

O Creates object program consisting of 

code, possibly read-only, 

initialized data or read-write code, 

uninitialized data. 
O Relocatable object code is directly executable without further transformation. 
O Object code normally includes a symbol table. 
O Multiple source files. 
O Local labels. 
O Conditional assembly. 

O "Conditional jump" instructions become branches or branches plus jumps 
depending on distance. 

D Library The basic run-time library. These routines are used freely by all software. 

O Buffered character-by-character I/O. 
O Formatted input and output conversion (SCANF and PRINTF) for standard 

input and output, files, in-memory conversion. 
O Storage allocator. 
OTime conversions. 
O Number conversions. 
O Password encryption. 
O Quicksort. 

O Random number generator. 
O Mathematical function library, including trigonometric functions and 

inverses, exponential, logarithm, square root, bessel functions. 
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□ ADB 



□ OD 



D LD 



D LORDER 


D NM 


a SIZE 


a STRIP 


DTIME 


D PROF 


a MAKE 



Interactive debugger. 

O Postmortem clumping. 

O Examination of arbitrary files, with no limit on size. 

O Interactive breakpoint debugging with the debugger as a separate process. 

O Symbolic reference to local and global variables. 

O Stack trace for C programs. 

O Output formats: 

1-, 2-, or 4-byte integers in octal, decimal, or hex 

single and double floating point 

character and string 

disassembled machine instructions 
O Patching. 

O Searching for integer, character, or floating patterns. 
O Handles separated instruction and data space. 

Dump any file. Output options include any combination of octal or decimal by 
words, octal by bytes, ASCII, opcodes, hexadecimal. 
O Range of dumping is controllable. 

Link edit. Combine relocatable object files. Insert required routines from 

specified libraries. 

O Resulting code may be sharable. 

O Resulting code may have separate instruction and data spaces. 

Places object file names in proper order for loading, so that files depending on 
others come after them. 

Print the namelist (symbol table) of an object program. Provides control over 
the style and order of names that are printed. 

Report the core requirements of one or more object files. 

Remove the relocation and symbol table information from an object file to save 
space. 

Run a command and report timing information on it. 

Construct a profile of time spent per routine from statistics gathered by time- 
sampling the execution of a program. Uses floating point. 
O Subroutine call frequency and average times for C programs. 

Controls creation of large programs. Uses a control file specifying source file 
dependencies to make new version; uses time last changed to deduce minimum 
amount of work necessary. 
O Knows about CC, YACC. LEX, etc. 



1.12. UNIX Programmer's Manual 



D Manual Machine-readable version of the UNIX Programmer's Manual. 

O System overview. 
O All commands. 
O All system calls. 

O All subroutines in C and assembler libraries. 
O All devices and other special files. 

O Formats of file system and kinds of files known to system software. 
OBoot and maintenance procedures. 
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D MAN 



Print specified manual section on your terminal. 



1.13. Computer- Aided Instruction 

D LEARN A program for interpreting CAI scripts, plus scripts for learning about UNIX by 

using it. 

O Scripts for basic files and commands, editor, advanced files and commands, 
EQN, MS macros, C programming language. 



2. Languages 

2.1. The C Language 



DCC 



D LINT 



DCB 



Compile and/or link edit programs in the C language. The UNIX operating sys- 
tem, most of the subsystems and C itself are written in C. For a full descrip- 
tion of C, read The C /Vo& mming Language, Brian W. Kernighan and Dennis 
M. Ritchie, Prentice-H 1978. 

O General purpose language designed for structured programming. 
O Data types include character, integer, float, double, pointers to all types, 

functions returning above types, arrays of all types, structures and unions of 

all types. 
O Operations intended to give machine-independent control of full machine 

facility, including to-memory operations and pointer arithmetic. 
O Macro preprocessor for parameterized code and inclusion of standard files. 
O All procedures recursive, with parameters by value. 
O Machine-independent pointer manipulation. 
O Object code uses full addressing capability of the PDP-11. 
O Runtime library gives access to all system facilities. 
O Definable data types. 
O Block structure 

Verifier for C programs. Reports questionable or nonportable usage such as: 

Mismatched data declarations and procedure interfaces. 

Nonportable type conversions. 

Unused variables, unreachable code, no-effect operations. 

Mistyped pointers. 

Obsolete syntax. 
O Full cross-module checking of separately compiled programs. 

A beautifier for C programs. Does proper indentation and placement of braces. 



2.2. Fortran 



O F77 A full compiler for ANSI Standard Fortran 77. 

O Compatible with C and supporting tools at object level. 
O Optional source compatibility with Fortran 66. 
O Free format source. 

O Optional subscript-range checking, detection of uninitialized variables. 
O All widths of arithmetic: 2- and 4-byte integer; 4- and 8-byte real; 8- and 16- 
byte complex. 

O RATFOR Ratfor adds rational control structure a la C to Fortran. 
O Compound statements. 
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O If-else, do, for, while, repeat-until, break, next statements. 

O Symbolic constants. 

O File insertion. 

O Free format source 

O Translation of relational like >, > — . 

O Produces genuine Fortran to carry away. 

OMay be used with F77. 

D STRUCT Converts ordinary ugly Fortran into structured Fortran (i.e., Ratfor), using 
statement grouping, if-else, while, for, repeat-until. 

2.3. Other Algorithmic Languages 

D BAS An interactive interpreter, similar in style to BASIC. Interpret unnumbered 

statements immediately, numbered statements upon 'run'. 
O Statements include: 

comment, 

dump, 

for.. .next, 

goto, 

if... else... fi, 

list, 

print, 

prompt, 

return, 

run, 

save. 
O All calculations double precision. 
O Recursive function defining and calling. 

O Builtin functions include log, exp, sin, cos, atn, int, sqr, abs, rnd. 
O Escape to ED for complex program editing. 

□ DC Interactive programmable desk calculator. Has named storage locations as well 

as conventional stack for holding integers or programs. 
O Unlimited precision decimal arithmetic. 
O Appropriate treatment of decimal fractions. 
O Arbitrary input and output radices, in particular binary, octal, decimal and 

hexadecimal. 
O Reverse Polish operators: 

+ - •/ 

remainder, power, square root, 

load, store, duplicate, clear, 

print, enter program text, execute. 

D BC A C-like interactive interface to the desk calculator DC. 

O All the capabilities of DC with a high-level syntax. 
O Arrays and recursive functions. 

O Immediate evaluation of expressions and evaluation of functions upon call. 
O Arbitrary precision elementary functions: exp, sin, cos, atan. 
O Go-to-less programming. 

2.4. Macroprocessing 
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Q M4 A general purpose macroprocessor. 

O Stream-oriented, recognizes macros anywhere in text. 

O Syntax fits with functional syntax of most higher-level languages. 

O Can evaluate integer arithmetic expressions. 

2.5. Compiler-compilers 

D YACC An LR(l)-based compiler writing system. During execution of resulting 

parsers, arbitrary C functions may be called to do code generation or semantic 
actions. 

O BNF syntax specifications. 
O Precedence relations. 
O Accepts formally ambiguous grammars with non-BNF resolution rules. 

D LEX Generator of lexical analyzers. Arbitrary C functions may be called upon isola- 

tion of each lexical token. 

O Full regular expression, plus left and right context dependence. 
O Resulting lexical analysers interface cleanly with YACC parsers. 

3. Text Processing 

3.1. Document Preparation 

D ED Interactive context editor. Random access to all lines of a file. 

O Find lines by number or pattern. Patterns may include: specified characters, 
don't care characters, choices among characters, repetitions of these con- 
structs, beginning of line, end of line. 

O Add, delete, change, copy, move or join lines. 

O Permute or split contents of a line. 

O Replace one or all instances of a pattern within a line. 

O Combine or split files. 

O Escape to Shell (command language) during editing. 

O Do any of above operations on every pattern-selected line in a given range. 

O Optional encryption for extra security. 

□ PTX Make a permuted (key word in context) index. 

D SPELL Look for spelling errors by comparing each word in a document against a word 

list. 

O 25,000-word list includes proper names. 
O Handles common prefixes and suffixes. 
O Collects words to help tailor local spelling lists. 

a LOOK Search for words in dictionary that begin with specified prefix. 

D TYPO Look for spelling errors by a statistical technique; not limited to English. 

Q CRYPT Encrypt and decrypt files for security. 

3.2. Document Formatting 

□ ROFF A typesetting program for terminals. Easy for nontechnical people to learn, and 

good for simple documents. Input consists of data lines intermixed with con- 
trol lines, such as 

.sp 2 insert two lines of space 

xe center the next line 

ROFF is deemed to be obsolete; it is intended only for casual use. 
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D TROFF 
D NROFF 



O Justification of either or both margins. 

O Automatic hyphenation. 

O Generalized running heads and feet, with even-odd page capability, number- 
ing, etc. 

O Definable macros for frequently used control sequences (no substitutable 
arguments). 

O All 4 margins and page size dynamically adjustable. 

O Hanging indents and one-line indents. 

O Absolute and relative parameter settings. 

O Optional legal-style numbering of output lines. 

O Multiple file capability. 

O Not usable as a filter. 



Advanced typesetting. TROFF drives a Graphic Systems phototypesetter; 

NROFF drives ascii terminals of all types. This summary was typeset using 

TROFF. TROFF and NROFF style is similar to ROFF, but they are capable of 

much more elaborate feats of formatting, when appropriately programmed. 

TROFF and NROFF accept the same input language. 

O All ROFF capabilities available or definable. 

O Completely definable page format keyed to dynamically planted "interrupts" 
at specified lines. 

O Maintains several separately definable typesetting environments (e.g., one for 
body text, one for footnotes, and one for unusually elaborate headings). 

O Arbitrary number of output pools can be combined at will. 

O Macros with substitutable arguments, and macros invocable in mid-line. 

O Computation and printing of numerical quantities. 

O Conditional execution of macros. 

O Tabular layout facility. 

O Positions expressible in inches, centimeters, ems, points, machine units or 
arithmetic combinations thereof. 

O Access to character-width computation for unusually difficult layout prob- 
lems. 

O Overstrikes, built-up brackets, horizontal and vertical line drawing. 

O Dynamic relative or absolute positioning and size selection, globally or at the 
character level. 

OCan exploit the characteristics of the terminal being used, for approximating 
special characters, reverse motions, proportional spacing, etc. 

The Graphic Systems typesetter has a vocabulary of several 102-character fonts (4 simultane- 
ously) in 15 sizes. TROFF provides terminal output for rough sampling of the product. 

NROFF will produce multicolumn output on terminals capable of reverse line feed, or through 
the postprocessor COL. 

High programming skill is required to exploit the formatting capabilities of TROFF and 
NROFF, although unskilled personnel can easily be trained to enter documents according to 
canned formats such as those provided by MS, below. TROFF and EQN are essentially identi- 
cal to NROFF and NEQN so it is usually possible to define interchangeable formats to produce 
approximate proof copy on terminals before actual typesetting. The preprocessors MS, TBL, 
and REFER are fully compatible with TROFF and NROFF. 



D MS 



A standardized manuscript layout package for use with NROFF/TROFF. This 
document was formatted with MS. 
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D EQN 



D NEQN 



DTBL 



O Page numbers and draft dates. 

O Automatically numbered subheads. 

O Footnotes. 

O Single or double column. 

O Paragraphing, display and indentation. 

O Numbered equations. 

A mathematical typesetting preprocessor for TROFF. Translates easily readable 
formulas, either in-line or displayed, into detailed typesetting instructions. For- 
mulas are written in a style like this: 

sigma sup 2 "— " 1 over N sum from i— 1 to N ( x sub i — x bar ) sup 2 



a REFER 

DTC 

a GREEK 



□ COL 

D DEROFF 

D CHECKEQ 



which produces: 



I v 

<T 2 - -^SU-X) 2 



O Automatic calculation of size changes for subscripts, sub-subscripts, etc. 

O Full vocabulary of Greek letters and special symbols, such as 'gamma', 

'GAMMA', 'integral'. 
O Automatic calculation of large bracket sizes. 

O Vertical "piling" of formulae for matrices, conditional alternatives, etc. 
O Integrals, sums, etc., with arbitrarily complex limits. 
ODiacriticals: dots, double dots, hats, bars, etc. 
O Easily learned by nonprogrammers and mathematical typists. 

A version of EQN for NROFF; accepts the same input language. Prepares for- 
mulas for display on any terminal that NROFF knows about, for example, 
those based on Diablo printing mechanism. 
OSame facilities as EQN within graphical capability of terminal. 

A preprocessor for NROFF/TROFF that translates simple descriptions of table 

layouts and contents into detailed typesetting instructions. 

O Computes column widths. 

O Handles left- and right-justified columns, centered columns and decimal-point 

alignment 
O Places column titles. 

O Table entries can be text, which is adjusted to fit. 
O Can box all or parts of table. 

Fills in bibliographic citations in a document from a data base (not supplied). 
O References may be printed in any style, as they occur or collected at the end. 
O May be numbered sequentially, by name of author, etc. 

Simulate Graphic Systems typesetter on Tektronix 4014 scope. Useful for 
checking TROFF page layout before typesetting. 

Fancy printing on Diablo-mechanism terminals like DASI-300 and DASI-450, 

and on Tektronix 4014. 

O Gives half-line forward and reverse motions. 

O Approximates Greek letters and other special characters by overstriking. 

Canonicalize files with reverse line feeds for one-pass printing. 

Remove all TROFF commands from input. 

Check document for possible errors in EQN usage. 
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4. Information Handling 



□ SORT Sort or merge ASCII files line-by-line. No limit on input size. 

O Sort up or down. 

O Sort lexicographically or on numeric key. 

O Multiple keys located by delimiters or by character position. 

O May sort upper case together with lower into dictionary order. 

O Optionally suppress duplicate data. 

O TSORT Topological sort — converts a partial order into a total order. 

D UNIQ Collapse successive duplicate lines in a file into one line. 

O Publish lines that were originally unique, duplicated, or both. 
O May give redundancy count for each line. 

D TR Do one-to-one character translation according to an arbitrary code. 

O May coalesce selected repeated characters. 
O May delete selected characters. 

O DIFF Report line changes, additions and deletions necessary to bring two files into 

agreement. 

O May produce an editor script to convert one file into another. 
O A variant compares two new versions against one old one. 

D COMM Identify common lines in two sorted files. Output in up to 3 columns shows 

lines present in first file only, present in both, and/or present in second only. 

O JOIN Combine two files by joining records that have identical keys. 

D GREP Print all lines in a file that satisfy a pattern as used in the editor ED. 

O May print all lines that fail to match. 
O May print count of hits. 
O May print first hit in each file. 

D LOOK Binary search in sorted file for lines with specified prefix. 

a WC Count the lines, "words" (blank-separated strings) and characters in a file. 

□ SED Stream-oriented version of ED. Can perform a sequence of editing operations 

on each line of an input stream of unbounded length. 
O Lines may be selected by address or range of addresses. 
O Control flow and conditional testing. 
O Multiple output streams. 
O Multi-line capability. 

a AWK Pattern scanning and processing language. Searches input for patterns, and per- 

forms actions on each line of input that satisfies the pattern. 
O Patterns include regular expressions, arithmetic and lexicographic conditions, 

boolean combinations and ranges of these. 
O Data treated as string or numeric as appropriate. 
O Can break input into fields; fields are variables. 
O Variables and arrays (with non- numeric subscripts). 
O Full set of arithmetic operators and control flow. 
O Multiple output streams to files and pipes. 
O Output can be formatted as desired. 
O Multi-line capabilities. 
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5. Graphics 

The programs in this section are predominantly intended for use with Tektronix 4014 storage 
scopes. 

D GRAPH Prepares a graph of a set of input numbers. 
O Input scaled to fit standard plotting area. 
O Abscissae may be supplied automatically. 
O Graph may be labeled. 
O Control over grid style, line style, graph orientation, etc. 

O SPLINE Provides a smooth curve through a set of points intended for GRAPH. 

O PLOT A set of filters for printing graphs produced by GRAPH and other programs on 

various terminals. Filters provided for 4014, DASI terminals, Versatec 
printer/plotter. 

6. Novelties, Games, and Things That Didn't Fit Anywhere Else 

a BACKGAMMON 

A player of modest accomplishment. 

a CHESS Plays good class D chess. 

D CHECKERS Ditto, for checkers. 

O BCD Converts ascii to card-image form. 

D PPT Converts ascii to paper tape form. 

O BJ A blackjack dealer. 

O CUBIC An accomplished player of 4x4x4 tic-tac-toe. 

O MAZE Constructs random mazes for you to solve. 

D MOO A fascinating number-guessing game. 

Q CAL Print a calendar of specified month and year. 

Q BANNER Print output in huge letters. 

a CHING The / Ching. Place your own interpretation on the output. 

O FORTUNE Presents a random fortune cookie on each invocation. Limited jar of cookies 
included. 



a UNITS 



DTTT 



Convert amounts between different scales of measurement. Knows hundreds 
of units. For example, how many km/sec is a parsec/megayear? 



A tic-tac-toe program that learns. It never makes the same mistake twice. 

D ARITHMETIC 

Speed and accuracy test for number facts. 

a FACTOR Factor large integers. 

O QUIZ Test your knowledge of Shakespeare, Presidents, capitals, etc. 

D WUMP Hunt the wumpus, thrilling search in a dangerous cave. 

Q REVERSI A two person board game, isomorphic to Othello*. 

D HANGMAN Word-guessing game. Uses the dictionary supplied with SPELL. 
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O FISH Children's card-guessing game. 



